home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / orderdor.zip / ORDERDOR.DOC < prev    next >
Text File  |  1991-08-03  |  15KB  |  298 lines
  1.  
  2.                           ▓▒░   OrderDoor  ░▒▓
  3.                           ▓▒░ Version 1.25 ░▒▓
  4.  
  5.  
  6.                              August 3, 1991
  7.  
  8.                              Premo Mondone
  9.                              Copyright 1991
  10.                      PC Solutions of Cleveland BBS
  11.  
  12.                PC Solutions of Cleveland - Cleveland, TN
  13.                      (615) 476-2874 1200/2400 Baud
  14.  
  15.  
  16.  
  17. Intro:
  18. ─────
  19.  
  20. OrderDoor was written using QuickBasic v4.5 utilizing Todd Miller's Door Source
  21. v3.2 Library.  OrderDoor is a simple easy to use door that doubles as two doors
  22. in one.  It is an on-line order door for accepting orders using Visa/MasterCard,
  23. etc. AND it doubles as an on-line BBS Subscription Door.  OrderDoor was designed
  24. to be somewhat configurable for the SysOp so that he can use any text file that
  25. is 80 characters or less as his "On-Line Catalog" of items available for sale.
  26. The only requirement here is that the text file be simply named "catalog" and
  27. placed in the OrderDoor directory.  The Subscription Fee for the BBS is also
  28. configurable via use of the Orderdor.cfg file that will be explained later in
  29. this documentation.
  30.  
  31. This software is marketed under the "shareware" concept.  The shareware version
  32. works exactly like the registered version, except the registered version does
  33. not have the "Please register" message present. The registered version has
  34. instead a nice message saying "Thanks for registering", etc. and even mentions
  35. the SysOp by name.  The registration fee is only $10.00 (U.S. Funds) and
  36. entitles you to free upgrades available for download on PC Solutions.
  37.  
  38. * NEW FEATURES *
  39. The registration fee ALSO entitles you to a copy of a simple utility
  40. (APPROVE.EXE) that will allow you to enter the approval number (ya asked for
  41. this) on each and every transaction. I have now included the report utility
  42. inside the door itself, (you guys asked for it, ya got it!) instead of an
  43. external module that is run from dos. The shareware version only prints some
  44. basic information to the screen and does NOT include all the information
  45. contained in each transaction. In the registered version it gives you the option
  46. of print ALL of the data in the file or only any NEW transactions (ya asked for
  47. this too and ya got it too!) that have occurred since the last time you printed
  48. the report!
  49.  
  50. This report option is password protected and the password is configurable by the
  51. SysOp, even in the shareware version. Please note that this password option is
  52. CASE SENSITIVE.
  53.  
  54. *MORE NEW FEATURES*
  55. Now when using the internal report function (to the screen), if you've
  56. already viewed the record, it will not show, therefore you will only be
  57. shown any new records since the last time you used the funtion. Also,
  58. with version 1.25, I added a simple labeling utility to print mailing
  59. labels from the charge.dat file. This is only included with the
  60. registered versions. I also added an OrderDoor Log function. Now,
  61. OrderDoor will maintain a log file of all who enter the Door. The
  62. filename that it creates is Orderdor.log.
  63.  
  64. * WARNING *: Because of all of the above changes the CHARGE.DAT file has changed
  65. significantly. Delete any old .dat files (after printing a report of course) and
  66. then create a new one. SPECIAL NOTE: The file format has changed
  67. slightly, from v1.24 & v1.25, so you need to delete any old files and
  68. begin fresh with the new format. I have included a sample charge.dat
  69. file that you can start off with.  Also, because of the above change, I
  70. made a slight modification to the Approve Module, so be sure and use the
  71. current copy in the registered archive.
  72.  
  73. I also added a new feature to the main menu. Some of you asked for it to be
  74. configurable, so I came up with a compromise. After the door displays the menu,
  75. it will also now display a simple ascii text file of your named "SPECIAL". This
  76. is where you can include any special instructions to the user. I have included a
  77. sample file so that you can see an example of what I'm talking about. It must be
  78. a pure ascii file and must be 80 columns or less. The sample file that I
  79. included is 3 lines long, it can be longer, but I'd keep it down to 5 or 6 so
  80. that the screen display looks ok. If it looks funny to ya, you may want to knock
  81. a line or two off.  WARNING: This file is required! If you fail to
  82. create one or use the sample provided, weird things may happen!
  83.  
  84. Door Source has many advantages over most Door Libraries for QuickBasic. One
  85. advantage is that the patched Brun45.exe is NOT needed.  In addition to the
  86. above it also has the following features:
  87.  
  88.           *  Handles comm port by assembly interrupt routines.
  89.           *  A sysop page routine.
  90.           *  Support for bauds up to 52,600 bps!
  91.           *  Properly credits chat time to caller's time left.
  92.           *  Always checking for a loss of carrier.
  93.           *  Supports PCBoard 14.x, PCBoard 11.x and 12.x!
  94.           *  Handles locking ports
  95.  
  96.  
  97. One of Door Source's advantages over some of the other door writing utilities is
  98. that Door Source can support several versions of PCBoard! Now with version 3.2
  99. of DoorSource, WildCat, RBBS and BBS Softwarer utilizing DOORSYS are also
  100. supported. The versions of PCBoard are 11.8 and up, including support for 14.0
  101. and up! The default bbs type is PCBoard 14.x. If you wish to change that, simply
  102. put this into your environment table by using the DOS command, SET in your
  103. autoexec.bat file.
  104.  
  105.   SET DORSRC=PCB14    -   Door Source will run PCBoard 14.x (DEFAULT)
  106.   SET DORSRC=PCB121   -   Door Source will run PCBoard 11.8+ with COM1
  107.   SET DORSRC=PCB122   -   Door Source will run PCBoard 11.8+ with COM2
  108.   SET DORSRC=WILDCAT  -   Door Source will run Wildcat
  109.   SET DORSRC=RBBS     -   Door Source will run in RBBS mode
  110.   SET DORSRC=DOORSYS  -   Door Source will use the DOOR.SYS
  111.  
  112. Another way to change the setting for the bbs type is on the command line,
  113. simply put PCB121 on the command line for PCBoard 11.8+ on COM1 and PCB122 on
  114. the command line for PCBoard 11.8+ on COM2, like this :
  115.  
  116.                       ORDERDOR ORDERDOR.CFG PCB121
  117.  
  118. For WildCat, and I suspect other systems, you MUST specify the BBS on the
  119. command line that fires up OrderDoor.  For example:
  120.  
  121.                       ORDERDOR ORDERDOR.CFG WILDCAT
  122.                       ORDERDOR ORDERDOR.CFG RBBS
  123.                       ORDERDOR ORDERDOR.CFG DOORSYS
  124.  
  125. I am not certain on the RBBS or DoorSys BBS's (I have yet to have a BETA tester
  126. from one of these systems verify this), but thanks to Gene Coleman, SysOp of the
  127. Silver Bullet (a WildCat BBS) I am certain that it works and is required for
  128. WildCat systems. You can't specify PCB14 on the command line, instead, Door
  129. Source will default to it.  To be safe, I would include the SET command in my
  130. autoexec.bat AND the bbs parameter as shown above in the command line that fires
  131. up OrderDoor.
  132.  
  133. You can also not specify anything at all, and let Door Source figure out the bbs
  134. type that you are using. But the filename for the information file has to be the
  135. same. Here are the filenames Door Source will look for in the first line of the
  136. configuration file:
  137.  
  138. PCBOARD.SYS  - PCBoard systems
  139. CALLINFO.BBS - WildCat systems
  140. DORINFO1.DEF - RBBS systems
  141. DOOR.SYS     - For DOOR.SYS usage
  142.  
  143. Setup:
  144. ─────
  145.  
  146. Setup for OrderDoor is real simple.  The batch file to load the door should be
  147. as follows:
  148.  
  149. F:                         <----- Drive containing OrderDoor
  150. cd\doors\orderdor          <----- Subdirectory containing OrderDoor
  151. orderdor orderdor.cfg      <----- Command Line to load OrderDoor
  152. D:                         <----- Drive containing PCB directory
  153. cd\pcb                     <----- Change directory to PCB
  154. board                      <----- Re-Load PCBoard
  155.  
  156.  
  157.  
  158. The config file for OrderDoor (orderdor.cfg), is as follows:
  159.  
  160. D:\pcb\pcboard.sys             <----- Drive & directory containing pcboard.sys
  161. PC Solutions                   <----- Name of your BBS
  162. Premo                          <----- SysOp's first name
  163. Mondone                        <----- SysOp's last name
  164. 15.00 for 3 months             <----- BBS Subscription fee #1
  165. 25.00 for 6 months             <----- BBS Subscription fee #2
  166. 50.00 for 1 year               <----- BBS Subscription fee #3
  167. 100.00 for Lifetime Membership <----  BBS Subscription fee #4
  168. bubba                          <----- Your password for the SysOp Report Option
  169. Visa                           <----- Credit Card #1 *NEW in this version.
  170. Mastercard                     <----- Credit Card #2   "   "   "     "
  171. Discover                       <----- Credit Card #3   "   "   "     "
  172. American Express               <----- Credit Card #4   "   "   "     "
  173.  
  174. Both files above can be created with any pure ascii editor. If you run a free
  175. BBS (no subscription fee), then you can put $0 in the place reserved for the
  176. subscription fee. Please note that OrderDoor now supports up to four (4)
  177. different BBS Subscription fees. If you only have one subscription fee, you MUST
  178. LEAVE THREE (3) BLANK LINE IN YOUR *.CFG FILE!  ALSO, just added to v1.24, lines
  179. 10, 11, 12 & 13 are used to display up to four (4) different credit cards that
  180. are accepted by your BBS.  If less than four are used, then there MUST be BLANK
  181. LINES left at the end of the config file. I only accept 3 credit cards on PC
  182. Solutions, so in my config file I have lines 10, 11 & 12 filled out with the
  183. last line (line #13) left blank.
  184.  
  185. There is also a "welcome" screen that is included that can be added to, but the
  186. information already contained in the "welcome" files maynot be deleted or
  187. altered. Feel free however to change colors, etc. as you see fit.  There should
  188. be both an ascii version and an ansi version as well.
  189.  
  190. Other features:
  191. ──────────────
  192.  
  193. OrderDoor while in operation will have the status line on the bottom the screen
  194. on line 24 and line 25. It will show these things:
  195.  
  196.             1. The caller's baud rate
  197.             2. The caller's name
  198.             3. Time left in the door in minutes.
  199.             4. The name of the door and release version number.
  200.             5. Door Source 3.2
  201.             6. The time the door was entered, current time and flags if any.
  202.             7. Graphics mode (GR) or (NGR)
  203.             8. Bell/Caller alarm toggle status
  204.  
  205. The function keys open for the sysop to use are the following:
  206.  
  207.         (F4)    Page Bell Toggle
  208.         (F7)    Caller Alarm Toggle
  209.         (F8)    Return the user to the bbs
  210.         (F10)   Start chat with user
  211.         (ESC)   End chat with user
  212.         (ALT-X) Exit to DOS after sign-off toggle
  213.         (ALT-N) Sysop on next toggle
  214.  
  215. That's about it for now.  I am open to suggestions on improving OrderDoor. This
  216. is the first version and I'm sure there will be some things that I left out or
  217. forgot.  I can be contacted on PC Solutions or the SysOp's Conference of any
  218. member of the LiteLink Mail Network.
  219.  
  220.  
  221. HISTORY:
  222. ───────
  223. January 26, 1991: Initial v1.0 released.
  224.  
  225. February 7, 1991: v1.1: Minor Bug fixed in BBS Subscription routine.
  226.  
  227. March 3, 1991: v1.2: Added User name from Users file to the data file. Also
  228. added a date/time stamp to the data file. Also an ASCII text search module was
  229. added for the catalog file.  And added support for WildCat, RBBS and Doorsys
  230. BBS's.
  231.  
  232. March 10, 1991: No release, but discovery of bugs when using WildCat or Gap BBS
  233. software. Everything runs fine on PCBoard systems. Todd Miller & I are working
  234. on this problem and hope to track it down soon.
  235.  
  236. April 6, 1991: v1.21: Fixed problem with multi-node *.cfg files and problem that
  237. cropped up if the *.cfg file was named anything other than Orderdor.cfg.
  238.  
  239. April 7, 1991: v1.22: Added support for up to four (4) BBS Subscription fees.
  240.  
  241. April 27, 1991: v1.23: Added new utility to edit approval codes into the data
  242. file for each transaction. I also got rid of the old external report utility and
  243. have now included it within the door itself. It will now also give you the
  244. option of printing all the data or only the new data since the last time a
  245. report was printed. The CHARGE.DAT file format has now changed. Delete any old
  246. .dat files (after printing a report of course) and create a new one.
  247.  
  248. May 21, 1991: v1.24: Added 4 more lines to the *.cfg file so that up to 4 credit
  249. cards can be entered in so that OrderDoor will display the cards that your BBS
  250. accepts (i.e. Visa, Mastercard, etc.)  I also made a few cosmeteic changes to
  251. both the door itself and the APPROVE.EXE utility.
  252.  
  253. August 3, 1991: v1.25: Fixed a couple of minor bugs that no one ever reported,
  254. but that I had spotted. I also fixed a bug that occured using the ASCII SEARCH
  255. function. If the user input an ENTER KEY, instead of some text, the routine
  256. displayed the entire catalog file. (I can't believe I never caught that one
  257. before now).  I changed the file format of charge.dat again, so that I could
  258. incorporate some of the changes in this version. The screen report function now
  259. remembers what records you've already seen and only shows you any new records. I
  260. also added a simple label printing routine, to print mailing labels from the
  261. charge.dat file (my own idea!). I also added a LOG function. Now,
  262. OrderDoor maintains a log file of all who enter the door. The filename
  263. for this file is: Orderdor.log.
  264.  
  265. Thanks to the folowing SysOps who have either help test OrderDoor or have
  266. provided valuable input into its development.
  267. ────────────────────────────────────────────────
  268. Steve Stanfield, SysOp of Skyline BBS
  269. Doug Carpenter, SysOp of PC Junction BBS
  270. John McEntee, SysOp of The Blue Moon BBS
  271. Gene Coleman, SysOp of The Silver Bullet BBS
  272. Neil Pieman, SysOp of The Door BBS
  273. Jeff Freeman, SysOp of The Front Porch
  274. Bart Flint, SysOp of The Year 2000
  275.  
  276. and of course, last but not least.....
  277. Todd Miller, SysOp of PC Technologies BBS.
  278.  
  279. Ordering Information:
  280. ────────────────────
  281.  
  282. OrderDoor may be ordered on-line at my BBS, PC Solutions of Cleveland via
  283. OrderDoor, or you may mail a check, made payable to:
  284.  
  285.                         Southern Computer Systems, Inc.
  286.                               2308 Guthrie Avenue
  287.                               Cleveland, TN  37311
  288.                               Attn: Premo Mondone
  289.  
  290. Once you've purchased OrderDoor, I'll upgrade your access on PC Solutions to
  291. that of an OrderDoor Supporter and then you may download your registered version
  292. and all subsequent versions from PC Solutions. When you log back-on you will be
  293. given the filename to download and the password necessary to get the registered
  294. version. PC Solutions is now a subscription BBS. If you are a subscriber AND an
  295. OrderDoor registered user, then you will receive a lifetime subscription for the
  296. cost of only a 1 year subscription ($20.00 per year).
  297.  
  298.